home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / tex / dvi24pin.zip / DVIEPS.DOC < prev    next >
Text File  |  1988-09-19  |  23KB  |  581 lines
  1. dvi(1L)             UNIX Programmer's Manual              dvi(1L)
  2.  
  3.  
  4.  
  5. NAME
  6.      dvieps - TeX DVI to Epson translator
  7.  
  8.  
  9. SYNOPSIS
  10.      dvieps [-a] [-b] [-c#] [-d#] [-e_V_A_R=_v_a_l_u_e]...
  11.           [-f_f_o_n_t_s_u_b_f_i_l_e] [-l] [-m#]
  12.           [-o#]...  [-o#:#]...  [-o#:#:#]...
  13.           [-p] [-q] [-r#] [-s#] [-v]
  14.           [-x#_u_n_i_t_s] [-y#_u_n_i_t_s] [-z] dvifile1 [ dvifile2]...
  15.  
  16.  
  17.  
  18. DESCRIPTION
  19.      Dvieps expects the name of the DVI file on the command line,
  20.      and  the  extension  ._d_v_i  can always be omitted.  As illus-
  21.      trated below, it issues a one-line identifier  message  and,
  22.      if  no  command line arguments are given, types a Unix-style
  23.      _u_s_a_g_e message.
  24.  
  25.      The output file will be given the name of the ._d_v_i file, but
  26.      with suffix ._e_p_s.
  27.  
  28.      As each ._d_v_i file is processed, a list of errors is  printed
  29.      on  the standard error unit, _s_t_d_e_r_r; this list is also saved
  30.      in a file with suffix ._e_r_r. This  file  is  not  created  if
  31.      there  are no errors.  As each page is printed, the physical
  32.      page number and the TeX page number(s) are printed without a
  33.      following  character return; after the last page, the string
  34.      ``[OK]'' is printed, followed by a  newline.  This  gives  a
  35.      convenient  progress  report  to  the terminal. If it is not
  36.      wanted, then the error output can be suppressed with the  -q
  37.      (quiet) option.
  38.  
  39.  
  40. OPTIONS
  41.      The order of command options and DVI file names is _n_o_t  sig-
  42.      nificant;  all  switch  values  apply to all DVI files.  DVI
  43.      files are processed in order from left to right.
  44.  
  45.      Letter case is _i_g_n_o_r_e_d in option switches:  -A  and  -a  are
  46.      equivalent.
  47.  
  48.      -a   Implement virtual font caching, if  possible.   When  a
  49.           font  file  is opened, a buffer is allocated to contain
  50.           the entire file, and the file is  then  read  with  one
  51.           system  call.  This is important primarily on networked
  52.           file systems, where the many random-access calls in the
  53.           font  file for small amounts of data entail substantial
  54.           network overhead.  With the entire file cached in local
  55.           memory,  this  overhead  is  removed.    The additional
  56.           memory required for the font file  buffers  amounts  to
  57.  
  58.  
  59.  
  60. Printed 12/31/87         21 October 1987                        1
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67. dvi(1L)             UNIX Programmer's Manual              dvi(1L)
  68.  
  69.  
  70.  
  71.           100K  to 200K bytes (assuming the compact ._p_k font file
  72.           format), which is not excessive.  If memory  cannot  be
  73.           allocated  for  a  font  file, then normal buffering of
  74.           small blocks is used.  A trace option  (-d64)  is  pro-
  75.           vided to monitor the font caching; see below.
  76.  
  77.      -b   Backwards order printing from the default.   For  exam-
  78.           ple,  laser  printers  using  the   Canon  LBP-CX print
  79.           engine  normally  receive   pages   in  reverse   order
  80.           because  they  stack printed side  up.  Some  have page
  81.           handling  mechanisms that stack them face  down, and in
  82.           such   a  case  -b  will  ensure that they  come out in
  83.           order 1, 2, ...  instead  of n, n-1, n-2, ...
  84.  
  85.      -c#  Print # copies of each output page.   Page  copies  are
  86.           printed consecutively; this does _n_o_t give multiple col-
  87.           lated copies of the entire job.
  88.  
  89.      -d#  Produce debugging output on _s_t_d_e_r_r if a non-zero  value
  90.           is  given.   Multiple -d switches may be specified, and
  91.           one may also  add  values  of  the  following  possible
  92.           options to obtain the switch value:
  93.  
  94.           _2    display page coordinates and metrics of each  out-
  95.                put  character, and print each character bitmap in
  96.                hexadecimal;
  97.  
  98.           _8    print filename and open mode  of  each  _s_u_c_c_e_s_s_f_u_l
  99.                file opening;
  100.  
  101.           _1_6   print filename and open mode of each  _u_n_s_u_c_c_e_s_s_f_u_l
  102.                file opening;
  103.  
  104.           _3_2   show discarded off-page text;
  105.  
  106.           _6_4   trace virtual font caching;
  107.  
  108.           _1_2_8  trace character setting (_l_o_t_s of output).
  109.  
  110.           For example, either -d8 -d16 or  -d24  will  trace  all
  111.           attempted file openings.
  112.  
  113.      -eVAR=value
  114.           Define an environment variable on the command line (see
  115.           the  later section ENVIRONMENT VARIABLES).  The accept-
  116.           able values for _V_A_R are  _D_V_I_H_E_L_P,  _F_O_N_T_L_I_S_T,  _T_E_X_F_O_N_T_S,
  117.           and  _T_E_X_I_N_P_U_T_S.   Under  normal use of the translators,
  118.           these can be set by MS-DOS set VAR=value commands.
  119.  
  120.      -f_f_o_n_t_s_u_b_f_i_l_e
  121.           Define an alternate font substitution file which is  to
  122.           be used instead of the default ones (see below).
  123.  
  124.  
  125.  
  126. Printed 12/31/87         21 October 1987                        2
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133. dvi(1L)             UNIX Programmer's Manual              dvi(1L)
  134.  
  135.  
  136.  
  137.      -l   Inhibit logging.
  138.  
  139.      -m#  Reset magnification to #.  The default for low  resolu-
  140.           tion  printers  is -m603, corresponding to 1/1.2^5 mag-
  141.           nification of 300-dot/inch fonts.  By TeX  conventions,
  142.           magnification 1000 corresponds to a 200-dot/inch output
  143.           device.  The default magnification is  always  adjusted
  144.           according  to  the output device resolution in order to
  145.           give a normal  page  size,  so  this  parameter  should
  146.           rarely be required.  Legal values are int((1000 or 1440
  147.           or 1500) x 1.2^(k/2) [k = -16  ...  16];  other  values
  148.           will  be  set  to  the nearest in this family.  Not all
  149.           fonts will be available in this wide  range,  and  most
  150.           installations  will  probably have only a half dozen or
  151.           so magnifications.
  152.  
  153.           Magnification values less than 25 are taken to be a TeX
  154.           magstep parameter which is applied to the standard mag-
  155.           nification  for  that  device.   For  example,   -m-0.5
  156.           selects  a  smaller  size,  and -m2 selects a size 1.44
  157.           times larger than normal.
  158.  
  159.      -o# _o_r -o#:# _o_r -o#:#:#
  160.           Specify a page number, or range of page numbers, to  be
  161.           selected  for  output.   In  the  third  form, the last
  162.           number is the page number step size; it is normally  1.
  163.           This  option  may be specified any number of times.  If
  164.           it is not specified, then all pages  will  be  printed.
  165.           Pages  are  numbered in order 1, 2, 3, ... in the file,
  166.           but any page number recorded by TeX on the printed page
  167.           will  in  general  be different.  Negative page numbers
  168.           count backward; -1 is the last page in the document, -2
  169.           the second last page, and so on.
  170.  
  171.           As pages are  selected  for  printing,  [#{#}  will  be
  172.           printed  on _s_t_d_e_r_r, where the first # is the sequential
  173.           page number in the file, and the second # is  a  string
  174.           of values of the TeX counters, \count0 through \count9,
  175.           separated by dots, with trailing zero counters dropped.
  176.           \count0  usually records the printed page number.  When
  177.           the page is completely output,  a  closing  ]  will  be
  178.           printed  on  _s_t_d_e_r_r. Any error messages from processing
  179.           of that page will therefore occur  between  the  square
  180.           brackets.   For  example,  -o1:3  -o12  -o17:23 -o-3:-1
  181.           would select pages 1, 2, 3, 12, 17, 18, 19, 20, 21, 22,
  182.           and 23, plus the last three pages.
  183.  
  184.           Pages are processed in the order found in the DVI file;
  185.           there  is  intentionally  no  attempt made to sort them
  186.           according to the \count0 values, since different  macro
  187.           packages  may  use this counter for different pu